home *** CD-ROM | disk | FTP | other *** search
/ Mac Mania 4 / MacMania 4.toast / / Tools&Utilities / mac-gzip-03b4 / README < prev   
Text File  |  1995-06-25  |  11KB  |  178 lines

  1. •  MacGzip 0.3ß4 (gzip 1.2.4)
  2.  
  3.     MacGzip is Jean-loup Gailly's gzip compressor (GNU zip) for the Macintosh, ported to Mac by SPDsoft and ported again for PowerMac by Erling Johansen <ejo@vingmed.no>
  4.  
  5.     Requires system 7 and it should work in any Macintosh if you have the correct combination of soft and CPU (if you want to know which version of MacGzip you have, choose 'get info' from the finder;  68K and FAT run on any Macintosh (FAT runs native for Power Macs); and the version for Power Mac only runs on Power Macs (you will get a -192 error if you try to open it on a 68K Mac))
  6.  
  7.     MacGzip can compress and decompress files; but as gzip is an UNIX compressor, if you gzip a Macintosh file, you will lose the resource fork (MacGzip will warn you before). Many text editors save things like font and size in the resource fork; custom icons are in the resource fork too; so for text and image files, you can discard the resource fork. If you want to retain all the information of any Mac file, you must use a MacBinary translator first. (Version 1.0 will do the translation; if some day I can find time enaugh to make it)
  8.  
  9.     You should read the files in 'GNU docs' folder…
  10.  
  11.  
  12. • Configuring MacGzip
  13.  
  14.     The easiest way to use MacGzip is as a Drag & Drop tool; depending on what you enter in the preferences dialog, the use can be fully automatic or manual.
  15.  
  16.     Note: 'open keys' are the keys you push while dragging a files/folders on MacGzip. You should hold them down until the window (for the first file) appears.
  17.  
  18.  - gzip standard options:
  19.  
  20.     * gzip suffix: This is the '-s' option of standard gzip. Here you can specify an optional suffix to use instead of '.gz'. If you are using the standard suffixes, let it empty. A note: unix gzip accepts any suffix when -s "" is used; in MacGzip empty means "no -s option". Should I change this?
  21.  
  22.     * Compression level: This is the '-[1-9]' option. The higher level, the slower and better compression. Compression level does not affect to decompression.
  23.  
  24.     * Force overwrite: This is the '-f' option. If you set it, MacGzip will overwrite files or empty folders if their names are the same of an output file.
  25.  
  26.     * -N: OK, this is not an option, in MacGzip its always on. (The original name and time stamp will be restored/saved)
  27.  
  28.     * -r: OK, this is not an option, in MacGzip, by now, its always on. (Drop Folders enabled)
  29. Note: there is not interface to control what happends when you drop a folder. MacGzip will try to open all the files (recursing over included folders) using the current settings (keys pushed on drop, preferences, etc).  This will change in the future. 
  30.  
  31.   - MacGzip options:
  32.  
  33.     * Signatures:
  34.  
  35.     Files compressed with gzip haven't any information about the kind of document of the original file; so to decompress them MacGzip has to guess it. Sometimes this can be done by looking at the suffix; when this fails, it will use these.
  36.     You can find more information about this in the 'Suffix Mapping' folder.
  37.  
  38.     * ASCII compress:
  39.  
  40.     This line tells to MacGzip when it has to convert newlines in the compression process. In the pop up menu you have 3 choices:
  41.  
  42.     1) Only for TEXT files: Only files which are recognised as TEXT by the Macintosh will be compressed in ASCII mode. This is a safe setting unless you have binary files whose type is 'TEXT' (for example if you are using Versaterm FTP Server), if this is your case, you should get a file typer to fix your files.
  43.  
  44.     2) Never: All files will be compressed in binary mode. This is the safest setting; if you aren't moving your compressed text files to a different operating system you'll never have problems with this.
  45.  
  46.     3) Use 'gzip' menu: This is more flexible, especially if you are using the 'open' menu instead of the Drag & Drop mode; but also more dangerous.
  47.  
  48.     4) Use Internet Config settings: If the best matching of your 'File Types' settings of Internet Config is marked as ASCII and not marked 'not for outgoing' ASCII mode will be used; if no matches are found, Binary mode will be used
  49.  
  50.  
  51.     You have an additional option: 'use open key'. If you check it, you can force ASCII compression by holding 'opt-a'  keys while dropping the files on MacGzip icon, overriding other settings.
  52.  
  53.    * ASCII uncompress:
  54.  
  55.     This line tells to MacGzip when it has to convert newlines in the decompression process. In the pop up menu you have 3 choices:
  56.  
  57.     1) Use Fetch Prefs: MacGzip will look in Fetch preferences for the suffix of the decompressed name. If the suffix is found, the mode will be read from Fetch Prefs; otherwise binary mode will be used. Additionally, if the suffix is found, the creator and type of the expanded file will be correct, too.
  58.  
  59.     2) Never: All files will be decompressed in binary mode. This is the safest setting; if you aren't moving your compressed text files to a different operating system you'll never have problems with this, and if you are getting compressed text files from the outside, you always can use a newline converter utility.
  60.  
  61.     3) Use 'gzip' menu: This is more flexible, especially if you are using the 'open' menu instead of the Drag & Drop mode; but also more dangerous.
  62.  
  63.     4) Use Internet Config settings: If the suffix matching of your 'File Types' settings of Internet Config is marked as ASCII and not marked 'not for incoming' ASCII mode will be used. Note that the default setting for IC are 'Macintosh' for many types which could be pure ASCII. You should verify all the settings after installing IC and before using any IC aware application.
  64.  
  65.     You have an additional option: 'use open key'. If you check it, you can force ASCII decompression by holding '-a'  key while dropping the files on MacGzip icon, overriding other settings.
  66.  
  67.  
  68. -Remember: A binary file transmitted or compressed in ASCII mode is lost!
  69.  
  70.     * Compress:
  71.  
  72.     This line tells to MacGzip when it has to compress or expand files:
  73.  
  74.     1) All non MacGzip Files: MacGzip will try to uncompress all files whose type does not match gzip, compress or zip; so if you have a compressed file without the correct type, MacGzip will try to compress it (you should get a better file transfer application...)
  75.  
  76.     To determine if a file is compressed, MacGzip first check its type; if this does not match 'Gzip', 'ZIVU' or 'pZIP', the suffix is tested against ".gz", ".z", ".Z", ".taz", ".tgz", "-gz", "-z" and "_z".
  77.  
  78.     2) Use 'gzip' menu: This is more flexible, especially if you are using the 'open' menu instead of the Drag & Drop mode.
  79.  
  80.     You have an additional option: 'use open key'. If you check it, you can force compression  by holding 'opt'  key while dropping the files on MacGzip icon, overriding other settings.
  81.  
  82. -Note: open keys should be hold down until the window appears.
  83.  
  84. • Using Macgzip
  85.  
  86.     Select your files/folders and drop them on MacGzip icon.
  87.  
  88.     The 'cancel' button (or cmd-period) raises a SIGINT and the program terminates (leaving the input file untouched and erasing the partial output file).
  89.  
  90.  
  91. • About types & creators
  92.  
  93.     I have used the following file Types:
  94.  
  95.        suffix   type    creator
  96.         .gz      Gzip     Gzip  gziped
  97.         .Z       ZIVU     Gzip  compressed (from maccompress)
  98.         .z       pZIP     Gzip  pkziped    (from UnZip 2.0.1)
  99.  
  100.     Anyway, read GNU’s gzip.doc to find out about formats.
  101.  
  102.     When you download a file from a non-mac host, the program that you are using to download must assign it two flags: File Type and File Creator.  These are two four character words that the Mac uses to know what icon they must have, what application must be opened when you make a double click on it, and if one SFGetFile (the 'open' dialog) should show the file or not.
  103.  
  104.     So, you should use a downloading application with a "suffix mapping" menu or preference, or at least, a drag&drop file typer.  With this version of MacGzip, you don't need to use the correct type, but is a good idea to keep your files well typed.
  105.  
  106.  
  107.     If you want MacGzip to set the correct types but you don't use Fetch, you can find a 'Fetch Prefs' file in the 'Suffix Mapping'. You can copy it to your Preferences folder (in your System folder); and if you want to add suffixes, you can edit it with ResEdit or other resource editor (there is a template included).
  108.  
  109.     Or you can use Internet Config, available from
  110.       ftp://redback.cs.uwa.edu.au//Others/PeterLewis/
  111.       ftp://ftp.nig.ac.jp/pub/mac/PeterLewis/
  112.       ftp://nic.switch.ch/software/mac/peterlewis/
  113.       ftp://amug.org/pub/peterlewis/
  114.       ftp://ftp.share.com/peterlewis/
  115.       ftp://cadadmin.cadlab.vt.edu/peterlewis/
  116.       ftp://ftp.acns.nwu.edu/pub/newswatcher/helpers/
  117.       ftp://ftp.tidbits.com/pub/tidbits/
  118.  
  119.  
  120.  
  121. • Warranty & so
  122.  
  123.     The guarantee is directly proportional to the price of the application: NONE. (OK, if you loose a very important file with 2.3 Mb of data, let me know it and I  will send you a few words of condolence).
  124.  
  125. • Thanks to:
  126.  
  127.  Jean-loup Gailly <jloup@chorus.fr> for gzip
  128.     Erling Johansen <ejo@vingmed.no> for the port to PPC (a nice job!) and Posix lib
  129.  Timothy Murphy <tim@maths.tcd.ie> for Posix lib used in the first versions.
  130.  Quinn "The Eskimo" <quinn@cs.uwa.edu.au> and
  131.  Peter N Lewis <peter.lewis@info.curtin.edu.au> for Internet Config Prog. Kit
  132.  tree@uvm.edu for SpinCursors code
  133.  Greg Robbins for Prefs code
  134.  C.K. Haun (Apple DTS) for Movable Modal code
  135.  Bryan Stearns (Apple DTS) for Pop Up  Menus code
  136.  Dave Rubinic for Easy Errors 1.0 resources
  137.  Lloyd Chambers (MacCompress) for Icons idea
  138.  David "ELEE74L" Alten <"elee74l@menudo.uh.edu"> for icons improvement
  139.  And all other people whose source code I used ‘for documentation’
  140.  
  141.  At last, thanks to myself
  142.     macspd@ivo.cps.unizar.es
  143.     spd@prometeo.cps.unizar.es
  144.  for being so nice company.
  145.  
  146.  Latest about MacGzip:
  147.     http://persephone.cps.unizar.es/general/gente/spd/gzip/gzip.html
  148.  
  149. • REWARD 0.000.000 $
  150.   BUGS (dead or alive)
  151.  
  152.        Cuando empiece este verano
  153.                -no en Londres-
  154.        disfrutaré de un descanso
  155.               -no en Nueva York-
  156.        se acabo el relax falso
  157.               -no en Bangkok-
  158.        no en países aburridos,
  159.        no en ciudades sin sentido,
  160.        sin pasar por las agencias,
  161.        en la morgue hallaré sitio
  162.  
  163.        Aire acondicionado, en la morgue.
  164.        armarios de metal, en la morgue,
  165.        Iuz eterna, en la morgue.
  166.        cómodo apartamento, en la morgue.
  167.        servicios religiosos, en la morgue.
  168.  
  169.        vacaciones
  170.        vacaciones
  171.        vacaciones en la morgue 
  172.  
  173.  
  174.                   ( La Mode, de 'Vacaciones en la morgue' )
  175.                   Letra de Fernando Márquez
  176.  
  177.  
  178.